home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / EDITORS / WORDHOUND / WORDHOUND_1 / !WordHound / Docs / !Intro < prev    next >
Text File  |  1992-08-09  |  9KB  |  199 lines
  1.  
  2.  
  3. Introduction to Word Hound
  4. ==========================
  5.  
  6. Once you have installed Word Hound (instructions on how to do this should have
  7. come with it) it is ready to use. To run simply double click on the
  8. application, and it will install itself on your iconbar.
  9.  
  10. Clicking 'menu' over it's iconbar icon will bring up Word Hounds menu, which
  11. contains 4 options (the usual Info and Quit options, plus a colours sub-menu
  12. and an entry marked 'Search').
  13.  
  14. Selecting 'Search' from the main menu, or simply clicking 'Select' over the
  15. iconbar icon will bring up the 'Enter' window.
  16.  
  17.  
  18. The 'Enter' Window
  19. ------------------
  20.  
  21. The 'Enter' window contains one writable icon, and three menu icons. The
  22. writable icon (marked 'Find :') is where you can enter the word you wish to
  23. search for. The three menu icons will make Word Hound take what ever word is
  24. in the writable icon and perform one of three searches :
  25.  
  26. - Normal 'Search' :
  27.   This search, which is also started by simply pressing RETURN after entering
  28.   the word in the writable icon, will make Word Hound search all the available
  29.   index files for the word in the writable icon. When all the entries within
  30.   the index files have been located, they are displayed in the 'Selection'
  31.   window (see below).
  32.  
  33. - 'Start' Search :
  34.   This search takes the letters in the writable icon (of which there must be
  35.   at least two) and searches the index files for all the words which start
  36.   with those letters. All located words will be listed in the 'Display'
  37.   window (see below).
  38.  
  39. - 'Sounds Like' Search :
  40.   This search takes the word in the writable icon, and searches the index files
  41.   for all words that might sound like that word. All located words are then
  42.   listed in the 'Display' window (see below).
  43.  
  44.  
  45. When you bring up the 'Enter' window by clicking 'Select' over it's iconbar
  46. icon, Word Hound will remember where the caret currently is, and will return
  47. it there every time you perform a search.
  48.  
  49.  
  50. The 'Selection' window
  51. ----------------------
  52.  
  53. This window is used after a normal search to display a list of the entries
  54. which contain the word searched for. This allows the user to then select which
  55. entries they wish to look at in full.
  56.  
  57. To explain the 'Selection' window it is best to give an example. So if you
  58. were to type "bellowing" into the writable icon and perform a normal search,
  59. the 'Selection' window will contain :
  60.  
  61.  Dictionary   bellow      : bellow
  62.  Thesaurus    bellow      : 404. Loudness.
  63.  Thesaurus    bellow      : 411. Cry.
  64.  Thesaurus    bellow      : 412.  Ululation.
  65.  
  66. The first column tells you which data file the entry is in, ie. Dictionary or
  67. Thesaurus. The next column tells you that actual word it located in the index
  68. (see below), and the third column tells you about that entry.
  69.  
  70. To display any of the entries listed, simply move the mouse pointer over that
  71. entry in the list and click 'Select' once. This will bring up the selected
  72. entry in the 'Display' window.
  73.  
  74. As you can see, although Word Hound found no entries for "bellowing" it did
  75. find some under "bellow". This is because Word Hound performs a 'fuzzy'
  76. search as it's normal search. This is explained in more detail later on in
  77. this file.
  78.  
  79.  
  80. The 'Display' window
  81. --------------------
  82.  
  83. The 'Display' window is used for displaying entries from data files, as well
  84. as the results from a 'Start' or 'Sounds Like' search. When used for entries
  85. in the data files, all occurrences of the word used in the search are
  86. highlighted so that you can locate them easily. This is particularly useful
  87. for thesaurus entries as these tend to be quite large, and contain much that
  88. is irrelevant to your search. Relevant words tend to be located around the
  89. word you searched for.
  90.  
  91. If you move the mouse pointer over any of the words displayed in the 'Display'
  92. window, the following actions will take place :
  93.  
  94.         Select - Word under pointer is passed to the application currently
  95.                  holding the caret.
  96.                  
  97.   Shift Select - Phrase, that the word under the pointer is in, is passed to
  98.                  the holder of the caret.
  99.                  
  100.         Adjust - Word under the pointer is looked up in all dictionary indexes
  101.                  (not thesaurus indexes) and the first located entry is
  102.                  shown in the 'Quick Definition' window (see below).
  103.                  
  104.   Shift Adjust - Word under the pointer is placed in the writable icon in the
  105.                  'Enter' window, and a normal search is performed on that word.
  106.  
  107.           Menu - Thus will bring up a 'Save as' box which will allow you to
  108.                  either save the contents of the window to a file, or drag
  109.                  the contents to another application. This is useful if you
  110.                  want to insert a definition into some text. Note, however,
  111.                  that the complete contents (minus colours) will be saved
  112.                  (passed on) and so you will probably need to edit out some
  113.                  of the text.
  114.  
  115.  
  116. The 'Quick Definition' window
  117. -----------------------------
  118.  
  119. This window is used a a second display window, and behaves just like the
  120. display window. The only difference is that it will only be used to show
  121. dictionary entries, and only used when you click 'Adjust' over a word in
  122. either the 'Display' window, or the 'Quick Definition' window itself.
  123.  
  124. When you call up a quick definition, all the index files of dictionary data
  125. files are searched (in order) to locate that word. If that word can't be
  126. located, then a 'fuzzy' search will be performed on that word (see the
  127. 'Selection' window section for information about the fuzzy search).
  128.  
  129.  
  130. The Word Hound 'Fuzzy' Search
  131. -----------------------------
  132.  
  133. When Word Hound searches for a word, either by the normal search or when
  134. you request a quick definition, it first builds up a list of variants on that
  135. word. These variants are designed to compensate for different parts of
  136. speech, and also to compensate between British and American spellings.
  137.  
  138. This is very useful, particularly when using the Impression hotlink (see
  139. the !Linking file for details) as it will increase the number of times
  140. Word Hound can locate the word you are looking for without you having to
  141. change the word to, say, it's singular version.
  142.  
  143. To give you an idea of what the fuzzy search can do, here is a list of
  144. initial words, and some (not all) the fuzzy versions that will also be
  145. searched for :
  146.  
  147.      Initial word         Fuzzy Versions
  148.      ------------         --------------
  149.  
  150.      colourise            colourize, colour, color, colourization
  151.      fully                full
  152.      fastest              fast
  153.      sceptre              scepter
  154.      defensive            defense, defence
  155.  
  156. This fuzzy search has nothing to do with the 'Sounds Like' search. 
  157.  
  158.  
  159. When Word Hound can't locate a word, not even with the fuzzy search
  160. -------------------------------------------------------------------
  161.  
  162. When Word Hound can't locate a word, it brings up the window you are expecting
  163. (ie. either the 'Selection' or the 'Quick definition' window) but simply
  164. places a message in that window telling you that it can't locate the word you
  165. are looking for.
  166.  
  167.  
  168. Notes
  169. -----
  170.  
  171. When Word Hound passes words to the application holding the caret it does not
  172. try to convert the words. For example, if you search for "tints" and then
  173. look under the thesaurus entry containing the word "tint" (singular) and then
  174. select the word "color" (American) to pass to your other application, Word
  175. Hound will NOT compensate for either your selection being singular (it does
  176. not add an extra 's') nor does is de-Americanise the word to colour. The
  177. reason that this does not happen is that there is no way Word Hound can know
  178. for sure whether the word can simply take an 's' ending, nor can it know that
  179. 'color' is American. The reason that it can work the other way during a search
  180. is that it searches for a whole list of possible versions of a word
  181. (eg. colours, colour, color) and thus it does not matter if some are not
  182. actually correct words).
  183.  
  184. Note also that although Word Hound only needs a 128k wimpslot to start up,
  185. when it has to display a 'Selection' window, or a 'Display' window or a
  186. 'Quick Display' window it needs to grab extra memory. Thus it is advisable to
  187. make sure that there is (at least) about 32k extra memory free for Word
  188. Hound to grab when it needs to. Word Hound only grabs this extra memory when
  189. it needs to, and also returns it as soon as it can (when the windows are
  190. closed).
  191.  
  192. When you use 'Shift Select' to pass a phrase to another application, Word
  193. Hound there are two things to note. First the pointer must be over a word
  194. in that phrase (not a space character). Second, if the phrase is split over
  195. two lines, then only that part which is on the line you click over will be
  196. passed on. This means that if a phrase is split you might need to pass
  197. each part separately.
  198.  
  199.